home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 026-050 / scopedisk28 / getfil / readme < prev    next >
Text File  |  1995-03-18  |  3KB  |  76 lines
  1. GetFile.ReadMe
  2.  
  3.  
  4. General Purpose File Requester
  5. ------------------------------
  6.  
  7.     This archive contains source files which contain code for
  8. a general purpose file requester.  The requester features ease of use,
  9. user specifiction of the requester title text and OK button text, 
  10. 3 standard device gadgets, and NO 'Wrong Diskette?' MESSAGES!!!!!!
  11.  
  12.     I sincerely hope you like this well enough to use it, in
  13. whole or in part.  The main reason I worked on this is because I 
  14. ABSOLUTELY DEPLORE those stupid, intelligence-insulting 'Wrong Diskette?'
  15. ('OK?') message boxes found in almost every new package (I've bought).
  16.  
  17.     There is no need to rub this in the face of someone who has
  18. just been prompted by the system itself to insert a disk.  To then be
  19. asked if what that was about was you having the wrong disk in place,
  20. especially if the programmer was STUPID enough to have hardcoded in
  21. a volume or device (other than DF0:), is aggravating.  It's not the
  22. user's fault that a program can't find a volume that's been hardcoded in.
  23.  
  24.     If you do not use this stuff, I won't mind.  Just please,
  25. Don't assume the user has booted off of your disk, is running off of DF0:,
  26. or has a DF1: (let alone ram:, hd:, or anything else).
  27.  
  28.     Your cooperation is greatly appreciated.  Thank you for your
  29. attention, and good day.
  30.  
  31.                     Dave Arendash
  32.                     Escape Velocity, Inc.
  33.                     405 Rancho Arroyo  #264
  34.                     Fremont, CA  94536
  35.  
  36.     This was originally posted on Compuserve, AmigaTech, C Programming
  37. Library, September 29, 1988.
  38.  
  39. This archive should contain:
  40.  
  41. getfile.c:    Contains the code for doing the requester.
  42.         The only routine you need to call here is 'get_fname()'.
  43.         Pass it a pointer to a default path, another to a default
  44.         file name.  If the user hits 'Cancel', these won't be
  45.         overwritten.  If he hits 'OK', they will be overwritten
  46.         with the path and filenames which appear in the string
  47.         gadgets at that time.  Returns 0 if unsuccessful for
  48.         any reason.
  49.  
  50. getfile.h:    The header file which contains structure and constant
  51.         definitions.
  52.  
  53. safeclose.c:    I don't know where this came from, but it is used to
  54.         close a window (in this case, the file requester)
  55.         gracefully.
  56.  
  57. filereq.h:    Contains the structure definitions for all the gadgets
  58.         and so forth for the requester.  This file was generated
  59.         with PowerWindows 2.0.
  60.  
  61. testing.c:    An example of how you'd typically call get_fname.  From
  62.         the PowerWindows 2.0 example, should be called from CLI.
  63.         First try uses df5: as a (silly) default path, illustrating
  64.         how this code deals with such nonsense.  The second uses
  65.         as defaults the results of the first try.
  66.  
  67. testing:    The executable, so you can run it to see if you like it.
  68.  
  69. makefile:    Example of how to set up your make.
  70.  
  71. getfile.readme:    This file.
  72.  
  73.     Your application must compile and link 'getfile' and 'safeclose'.
  74. I did this all with Manx Aztec C, but since I never use 'ints', it should
  75. work under any C.
  76.